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GRTensorJ - Books is an active interface to a small part of the computer algebra systems GRTen- 
sorll (for Maple) and GRTensorM (for Mathematica) with the specific intent of providing students 
of General Relativity with an advanced programmable calculator- style tool. All standard functions 
associated with a classical tensor approach to the subject are available thus reducing these to "el- 
ementary functions". This is not a traditional database. The database entries are spacetimes and 
calculations are done in real time. All spacetimes are referenced directly by equation number in 
ten current (and classic) texts in notation as close as possible to the original text. The tool is now 
available free of charge from grtensor.org/teaching . 

I. MOTIVATION 

Recently Hartle [l| has emphasized the increasing importance of General Relativity on the frontiers of both the 
very largest and the very smallest distance scales, a fact reflected by the increasing number of undergraduate physics 
majors being introduced to the subject. Of course, one can only learn physics by doing it, but many of the standard 
functions of General Relativity, when taught through classical tensor methods, involve only partial differentiation and 
summation. I believe that little is to be gained by repetitive routine calculations of this nature. For this reason, I 
would like to introduce here a tool that will be of use for all students starting their study of General Relativity. The 
purpose of the tool is to turn all standard (tensor based) functions into "elementary functions" - those immediately 
available with the click of a button - so that the inner beauty of General Relativity shines through. 

II. BACKGROUND 

The tool described here involves and update [3 to the Java interface GRTensorJ Q. The workings of the 
interface have been described in detail previously The version of GRTensorJ described here cannot be run over 
the internet but rather is a local application. The interface currently covers every spacetime (referenced by equation 
number and in notation as close to the original as possible) in the following texts: 

• Carroll, Sean. Spacetime and Geometry: An Introduction to General Relativity, Addison Wesley (San Francisco), 
2004. ISBN 0-8053-8732-3 

• d'Inverno, Ray. Introducing Einstein's Relativity, Clarendon Press (Oxford), 1992. ISBN 0-19-859686-3 

• Hartle, James. Gravity: An Introduction to Einstein's General Relativity , Addison Wesley (San Francisco), 
2003. ISBN 0-8053-8662-9 

• Hawking, Stephen, and G.F.R. Ellis. The Large Scale Structure of Spacetime , Cambridge University Press 
(Cambridge), 1973. ISBN 0-521-09906-4 

• Misner, Charles, Kip Thorne and John Wheeler. Gravitation , W.H. Freeman and Co. (San Francisco), 1973. 
ISBN 0-7167-0344-0 

• Poisson, Eric. A Relativist's Toolkit: The Mathematics of Black-Hole Mechanics , Cambridge University Press 
(Cambridge), 2004. ISBN 0-521-83091-5 

• Rindler, Wolfgang. Relativity: Special, General and Cosmological , Oxford University Press (Oxford), 2001. 
ISBN 0-19-850836-0 

• Schutz, Bernard. A First Course in General Relativity , Cambridge University Press (Cambridge), 1990. ISBN 
0-521-27703-5 

• Wald, Robert. General Relativity , University of Chicago Press (Chicago), 1984. ISBN 0-226-87033-2 

• Weinberg, Steven. Gravitation and Cosmology: Principles and Applications of the General Theory of Relativity, 
John Wiley and Sons (New York), 1972. ISBN 0-471-92567-5 
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GRTensorJ menu item GRTensorJ sub-menu command Object(s) 



Metric 
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Einstein 
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Bach 
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R(up,dn,dn,dn) 

R(up,up,dn,dn) 
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G(dn,dn) ... 

Invariants- Ricci 

Invariants- Weyl 
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diRicci 
diRiem 
diS 

diWeyl 

T(dn,dn,dn,dn) 
Weyl-Schouten . 
B(dn,dn) ... 
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Sig 
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det(g) 

g a b 
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1 ab 

Writes out the geodesic equations 

Rabcd 
R a bed 
it c d 

-p>abcd 

r> ryabed 
it a bed -tt 

Cabcd 

C* — 1 - /^e / 

abed — 2 tabe f i ~ y cd 

Rab — R acb 
Sab = Rab ~ J^QabR 
Gab — Rab ~ hgabR 



p — pa pi — 1 QQ> ab no — — 1 C a Qb Q c 
It = tt a , It I = tO biJ a, tt£ — — T-O biJ a 



rjn — 1 no Qp QC Qd 

= 16 ^ c ^ a 



wu = he* abci c 



abc d 



a b 



W2R=^C ab cd C cd ef C ef 
W2I =^C* ab cd C cd ef C ef ab 

MIR = ±S ab S Cd Cabcd, Mil = lS ab S Cd C* abed 

M2R = ±S cd S e} iC acdb C aefb - C* acdb CT fb ) 

M2I=lS bc S ef (C: bcd C^ fd ) 

M3 = ±S cd Se f (C acdb C aefb + C* acdb cr fb ) 

MA = ^S CSI S el S C d (Cac ^Cbefg + C* c ^Cfofg) 

A15R = JjS"^ C a3hb (C ac db C gef h + C ' aedtfi gefh) 

= 32'5 Cd C* a9hb (C ac ,d b C gef h + C* cdb C* e fh) 
l/c D — 1 C B a f C d/~tab _ 



M6R= ^Sa e S e c S b f S f d C 
M&I = ±.S a e S e c S b f S f d C 
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Ti s~i /^ia b | s~i* a b 

cdef = \-yacdb*~y ef ~T~ w acdb*~s ef 

' ' = -Rafe;c — -Rac;fe _ {9abR G e;c — QacR^ /;&)/4 



p — ^ :bd I 1 Tybd/-i 

D ac = ^abed ' T ^ O a bcd 



TABLE I: Initial set of preprogrammed objects available for coordinate calculations (condensed). Note: 
index combinations are immediately available as with Riemann. 



means that all 



III. PREPROGRAMMED CALCULATIONS 



In addition to a complete help system, the initial set of preprogrammed objects available for coordinate calculations 
is shown in TABLE 1. Note that the table is condensed as, for example, all index configurations are immediately avail- 
able. Note also that context - sensitive mathematical information is embedded as explained below. The introduction 
of further objects is also described below. 



IV. LOADING A SPACETIME AND WORKING WITH IT 

FIG. [2 shows a screen shot of the interface running Maple 10 0| under Windows XP and samples the coverage 
associated with the classic text by Misner, Thorne and Wheeler. Assuming you have the text, you simply click on 



3 



the equation number to load the spacetime. 

FIG. |3 shows loading of the Kruskal - Szekeres covering of the Schwarzschild vacuum as discussed by Poisson. 
We use this example here because the coordinates are implicitly defined and therefore involve constraints which can 
be seen in the figure. Without these constraints the spacetime is not defined. FIG. shows the result of applying 
constraints to the calculation of the Kretschmann scalar (see TABLE 1). 

As mentioned above, the interface contains context - sensitive embeded mathematical information. An example is 
shown in FIG. 0] where one notices that there are only four Ricci invariants available for calculation. The reason for 
this is given in the explanation as shown in FIG. 8J. 

V. INTERFACE EXPANSION 

At the time of writing, virtually any calculation one encounters in classical tensor analysis is already programmed 
into the interface. Further routines can be easily added through the GRTensorll grdef and GRTensorM grdef ine 
facilities. This includes tetrad calculations which we do not discuss here. To see how to program the interface, let us 
look at the construction of the Weyl-Schouten tensor (equivalently, the Cotton- York tensor which is also available). 
This is a three index tensor which in three dimensions is zero if and only if the space is conformally flat. As can be 
see from TABLE 1, it is defined by 

WS a bc = Rab;c ~ Rac-b ~ {9abR e e;c ~ 9acR^ /;h)/4, 

where the terms are defined in the table. This relation is programmed into the interface by including a plain text file 
(Weyl-Scouten.ts) the entire contents of which are: 

grdef ( c WS{a [be] }:=R{a b ; c}-R{a c ; b}-(g{a b}*R{~e e;c}-g{a c}*R{~f f ; b})/4'); 
greale (WS (dn , dn , dn) ) ; 
*grdisplay(_) ; 



VI. SYSTEM REQUIREMENTS 

To run GRTcnsorJ - Books you need Java 3] installed on your computer and a version of Maple or Mathematica. 
(You do not need to have GRTensorll or GRTensorM already installed.) The Maple version (tested on Maple 7, 8, 
9, 9.5.2, 10 and student 10) for Windows (tested on 2000 and XP) is available now from grtensor . org/teaching. 
Versions for other platforms, and updates, will be announced at the web site as they are available. 
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FIG. 1: A look at the middle section of the classic text by Misner, Thorne and Wheeler. 
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Equation 5.9, Schwar zsehild, Poisson, Copyt: 



FIG. 2: Loading of the Kruskal - Szckeres covering of the Schwarzschild vacuum as discussed by Poisson. 
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FIG. 3: Applying constraints to the calculation of the Kretschmann scalar (see Table 1). 
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FIG. 4: Calculation of Ricci invariants. 
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Explanation Ricci Invariants: 



In spacetime there are at most four independent Ricci invariants. 

Ricci invariants of higher order are governed by syaygies. 

Define r_n to be the inner product of n+1 trace-free Ricci tensors. 

The sysygies for r_n for n=4 ... 10 are : 

6r_4 - 5 r_l r_2 = U , 

24r_5+3r_l A 3-3r_2 A 2-18r_lr_3=0' , 

24 r_6 -7 r_2 r_l A 2 -14 r_3 r_2 = 0, 

144r_7-3 6r_3 A 2-64r_lr_2 A 2-3 6r_l A 2r_3+9r_l A 4=0, 

3 6r_8-4r_2 A 3-2 7r_lr_2 r_3=0, 

57 6r_9-160r_2 A 2r_3-13 0r_lr_3 A 2-160r_l A 2r_2 A 2+9r_l A 5=0; 
1728r_10-396r_2r_3 A 2-352r_lr_2 A 3-792r_l A 2r_2r_3+99r_l A 4r_2=0. 

See, for example , Santosuosso, K . f Pollney, D . , Pelavas , If . , Musgrave , P . and 
Lake, K. 1998 "Invariants of the Rieinann tensor for a class of space times." 
Comput.Phys.Commun. 115 (1993) 331-394 ( gr-qc/9309012) 



FIG. 5: Explanation for the choice of Ricci invariants. 



